home *** CD-ROM | disk | FTP | other *** search
/ Die Ultimative Software-P…i Collection 1996 & 1997 / Die Ultimative Software-Pakete CD-ROM fur Atari Collection 1996 & 1997.iso / falcon / powermix / gemram16 / gemram.eng next >
Encoding:
Text File  |  1996-09-18  |  7.5 KB  |  163 lines
  1. NAME
  2.      GEMRAM 1.6 [10/15/1993] - Installs GEM in RAM 
  3.  
  4. DESCRIPTION
  5.      GEMRAM installs a copy of GEM in RAM. This is necessary if you
  6.      use patch programs like WINX, ARROWFIX or SHBUF. GEMRAM supports
  7.      the following official GEM versions:
  8.      
  9.         GEM(AES)   TOS
  10.           1.20     GER 1.00/1.02
  11.           1.40     GER 1.04/1.06/1.62
  12.           3.00     GER 3.01
  13.           3.10     GER 2.05/3.05
  14.           3.20     GER 2.06/3.06
  15.           3.31     4.01
  16.           3.40     4.02-4.04
  17.  
  18.      GEMRAM identifies GEM by the length of the GEM-TEXT-Segment.
  19.      GEM Versions of foreign/unknown countries are accepted if the
  20.      length is identical.
  21.  
  22.      You can use GEMRAM to set the environment of GEM. To do this
  23.      put the single environment lines in a file GEMRAM.ENV. GEMRAM
  24.      looks for this file in the folder \AUTO on the boot drive.
  25.  
  26. INSTALLATION
  27.      GEMRAM lives in the \AUTO folder of the boot drive and is called
  28.      automatically on every re-boot of the system. You should sort
  29.      the files in the \AUTO folder in a way that GEMRAM runs before
  30.      programs like WINX, ARROWFIX or SHBUF. The best place for 
  31.      GEMRAM.ENV is the \AUTO folder too.
  32.      It's possible to use GEMRAM together with MiNT.
  33.  
  34. DESCRIPTION OF RESIDENT MEMORY
  35.  
  36.      vectors                     memory         comment
  37.  
  38.                            -----------------
  39.                            | PD  128 Bytes |
  40.      GEMRAM-Cookie ------> -----------------    -
  41.                            |    gemramS    |    GEMRAM structure
  42.                            |               |     (undocumented)
  43.      _exec_os --- ... ---> |- - - - - - - -| --- ... -----> GEM-TEXT
  44.                            |               |    installs OSHEADER
  45.                            | exec_os code  |     in RAM and inserts
  46.                            |               |     environment
  47.      _sysbase -----------> |- - - - - - - -|    -
  48.       (after exec_os)      |   OSHEADER    |    TOS structure
  49.                            -----------------    -
  50.                            |               |
  51.                            |   GEM-TEXT    |
  52.                            |               |
  53.      _sysbase->os_magic -> |- - - - - - - -|    in case GEMRAM
  54.                            |   GEM-MAGIC   |     copies GEM from ROM
  55.                            |- - - - - - - -|     or loads GEMRAMSYS
  56.                            |               |
  57.                            |   GEM-DATA    |
  58.                            |               | 
  59.                            -----------------    -
  60.                            |               |    in case GEMRAM
  61.                            |    GEM-BSS    |     loads GEMRAMSYS
  62.                            |               |
  63.      _gemenvptr ---------> -----------------    -
  64.       (after exec_os)      |    GEM-ENV    |    in case GEMRAM
  65.                            |               |     finds GEMRAM.ENV
  66.      _cookies -----------> -----------------    -
  67.                            |   cookie jar  |    in case the old
  68.                            |               |     jar is too small
  69.                            -----------------
  70.  
  71. TERMINATE AND KEEP RESIDENT
  72.      GEMRAM is a TKR-program and made of a TKR-loader, in which the
  73.      TKR-module 'GEMRAM.TKR' has been inserted. The concept of TKR is
  74.      that programs, which need resident memory (TKR-modules), get this
  75.      amount of memory given from another program (the TKR-loader).
  76.      Following this concept, the TKR-module can be concentrated to its
  77.      real work and only uses a minimum of memory. The used TKR-Loader
  78.      can contain an unlimited amount of TKR-modules and other programs.
  79.      If you press the SHIFT-key while the TKR-Laoder is started, the
  80.      loader asks for each TKR module if it should be started. The TKR-
  81.      loader displays the amount of memory that will be kept resident
  82.      after end of installation.
  83.  
  84. VEKTORS, COOKIES, ETC.
  85.      GEMRAM modifies the vector _exec_os. The XBRA id is 'MOGR'.
  86.      The _sysbase vector points to a copy of the OSHEADER. The os_magic
  87.      entry of the copy points into the GEM in RAM.
  88.      GEMRAM generates the cookie 'MOGR'. This cookie holds a pointer
  89.      to the GEMRAM structure. If the old cookie jar is too small GEMRAM
  90.      install a bigger one (XBRA 'MOGR').
  91.  
  92.      Because GEM now runs in RAM all vectors modified by GEM also point
  93.      into RAM.
  94.  
  95.      GEMRAM tries to find out the language for its messages looking at
  96.      the OSHEADER, after this, the _AKP cookie is checked (if existing).
  97.      On start from Desktop, the environment variable AE_LANG is
  98.      additionally checked. If the returned language is different from
  99.      german, english messages are used. The display format for the
  100.      date is derived from the _IDT cookie and if this cookie does not
  101.      exist, from the language setting.
  102.      
  103. CHANGES
  104.      v1.6: Additional derelocation infos for more TOS versions
  105.      v1.5: Second try to support Falcons...
  106.      v1.4: Small problem with environment fixed
  107.      v1.3: TOS 4.01-4.04 support; GEMRAM now looks for the ROM GEM 
  108.            first at the end of the _exec_os XBRA chain and then
  109.            in OSHEADER; It's possible to install a GEM.SYS file
  110.            via GEMRAM.SYS
  111.      v1.2: Support of USA/UK TOS versions; GEM environment;
  112.      v1.1: Fixed Bug in relocation infos of TOS 1.62
  113.  
  114. KNOWN PROBLEMS
  115.      Some programs (TSRs), which try to add themselves into the GEM
  116.      trap 2, may have problems to do this because the pointer now
  117.      points into RAM.
  118.      The environment of GEM 1.20 can't become bigger than 50 bytes.
  119.      Sometimes it's necessary to switch of the processor cache until
  120.      the installation of GEMRAM has finished.
  121.      
  122. COPYRIGHT
  123.      Author:     (\/) Martin Osieka
  124.      Adress:     Martin Osieka, Erbacherstr. 2,
  125.                  D-64283 Darmstadt, Bundesrepublik Deutschland
  126.      Internet:   Martin_Osieka@mtk.maus.de
  127.  
  128.      If you write letters and would like to get an answer, please do
  129.      not forget to submit a self-adressed envelope with enough
  130.      international answer coupons or german stamps.
  131.  
  132.      GEMRAM is freeware and may be distributed in ANY form as long as
  133.      program and all texts are distributed in a complete, unmodified
  134.      form. The files are:
  135.  
  136.          GEMRAM.PRG              program
  137.          GEMRAM.ENG, GEMRAM.GER  documentation (english, german)
  138.          GEMRAM.UPL              upload-description (german)
  139.          GEMRAM.ENV              example of an environment
  140.  
  141. WARNING
  142.      This program worked stable and normal behaved for some time in
  143.      my own programming environment. Besides all tries to avoid bugs
  144.      in development and testing you have to be aware, that this is
  145.      based on the analysis of internal GEM Code. GEM has parts, but
  146.      I wouldn't claim that, what I saw 'structured'. For this reason
  147.      it easily may happen, that someone misses a point somewhere.
  148.      And this is in fact VERY easy. For this reason, I include the
  149.      following message:
  150.  
  151.      *********************************************************************
  152.      * THIS PROGRAM COMES WITH ABSOLUTELY NO WARRANTY AGAINST MISUSE,    *
  153.      * DATA LOSS, BRAIN DAMAGE, EARTHQUAKE AND WHATEVER MAY HAPPEN       *
  154.      * BEFORE/AFTER OR WHILE USING IT. IT IS ABSOLUTELY *YOUR OWN* RISK. *
  155.      *********************************************************************
  156.  
  157.      This cannot be emphazised enough, if you indeed use this program
  158.      together with dirty programming trick software.
  159.  
  160. MANY THANKS TO
  161.      Normen B. Kowalewski for translation of main parts of this document
  162.  
  163.